<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html
    PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<!-- qwwnavigationbar.cpp -->
<head>
  <title>Qt 1.0: QwwNavigationBar Class Reference</title>
  <link href="classic-4.6.css" rel="stylesheet" type="text/css" />
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td align="left" valign="top" width="32"><a href="http://www.trolltech.com/products/qt"><img src="images/qt-logo.png" align="left" border="0" /></a></td>
<td width="1">&nbsp;&nbsp;</td><td class="postheader" valign="center"><a href="index.html"><font color="#004faf">wwWidgets Home</font></a>&nbsp;&middot; <a href="classes.html"><font color="#004faf">All&nbsp;Classes</font></a>&nbsp;&middot; <a href="mainclasses.html"><font color="#004faf">Main&nbsp;Classes</font></a>&nbsp;&middot; <a href="groups.html"><font color="#004faf">Grouped&nbsp;Classes</font></a>&nbsp;&middot; <a href="functions.html"><font color="#004faf">Functions</font></a></td>
<td align="right" valign="top" width="230">
<a href="http://www.wysota.eu.org/wwwidgets"><img src="images/ww-logo.png" align="right" width="137" height="41" border="0" /></a>
</td></tr></table><h1 class="title">QwwNavigationBar Class Reference<br /><span class="small-subtitle">[<a href="wwwidgets.html">wwWidgets</a> module]</span>
</h1>
<p>The QwwNavigationBar class provides a widget similar to MS Outlook navigation bar. <a href="#details">More...</a></p>
<pre> #include &lt;QwwNavigationBar&gt;</pre><p><b>This class is not part of the Qt GUI Framework Edition.</b></p>
<p>Inherits <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a>.</p>
<ul>
<li><a href="qwwnavigationbar-members.html">List of all members, including inherited members</a></li>
</ul>
<hr />
<a name="properties"></a>
<h2>Properties</h2>
<ul>
<li><div class="fn"><b><a href="qwwnavigationbar.html#currentIndex-prop">currentIndex</a></b> : int</div></li>
<li><div class="fn"><b><a href="qwwnavigationbar.html#topWidgetVisible-prop">topWidgetVisible</a></b> : bool</div></li>
</ul>
<ul>
<li><div bar="2" class="fn"></div>58 properties inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#properties">QWidget</a></li>
<li><div bar="2" class="fn"></div>1 property inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#properties">QObject</a></li>
</ul>
<hr />
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#QwwNavigationBar">QwwNavigationBar</a></b> ( QWidget * <i>parent</i> = 0 )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#addWidget">addWidget</a></b> ( QWidget * <i>child</i>, const QIcon &amp; <i>icon</i>, const QString &amp; <i>label</i> = QString::null )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#addWidget-2">addWidget</a></b> ( QWidget * <i>child</i>, const QString &amp; <i>label</i> = QString::null )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const QPushButton * </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#button">button</a></b> ( int <i>index</i> ) const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#currentIndex-prop">currentIndex</a></b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#indexOf">indexOf</a></b> ( QWidget * <i>widget</i> ) const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#insertWidget">insertWidget</a></b> ( int <i>index</i>, QWidget * <i>child</i>, const QIcon &amp; <i>icon</i>, const QString &amp; <i>label</i> = QString::null )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#insertWidget-2">insertWidget</a></b> ( int <i>index</i>, QWidget * <i>child</i>, const QString &amp; <i>label</i> = QString::null )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#removeWidget">removeWidget</a></b> ( int <i>index</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#setCurrentWidget">setCurrentWidget</a></b> ( QWidget * <i>widget</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#setWidgetIcon">setWidgetIcon</a></b> ( int <i>index</i>, const QIcon &amp; <i>icon</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#setWidgetLabel">setWidgetLabel</a></b> ( int <i>index</i>, const QString &amp; <i>label</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#topWidgetVisible-prop">topWidgetIsVisible</a></b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">QWidget * </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widget">widget</a></b> ( int <i>index</i> ) const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetCount">widgetCount</a></b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">QIcon </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetIcon">widgetIcon</a></b> ( int <i>index</i> ) const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">QString </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetLabel">widgetLabel</a></b> ( int <i>index</i> ) const</td></tr>
</table>
<ul>
<li><div bar="2" class="fn"></div>217 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#public-functions">QWidget</a></li>
<li><div bar="2" class="fn"></div>13 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qpaintdevice.html#public-functions">QPaintDevice</a></li>
<li><div bar="2" class="fn"></div>29 public functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-functions">QObject</a></li>
</ul>
<hr />
<a name="public-slots"></a>
<h2>Public Slots</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#currentIndex-prop">setCurrentIndex</a></b> ( int <i>index</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#topWidgetVisible-prop">setTopWidgetVisible</a></b> ( bool <i>v</i> )</td></tr>
</table>
<ul>
<li><div bar="2" class="fn"></div>19 public slots inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#public-slots">QWidget</a></li>
<li><div bar="2" class="fn"></div>1 public slot inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-slots">QObject</a></li>
</ul>
<hr />
<a name="signals"></a>
<h2>Signals</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#currentIndexChanged">currentIndexChanged</a></b> ( int <i>index</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#topWidgetVisibleChanged">topWidgetVisibleChanged</a></b> ( bool <i>vis</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetIconChanged">widgetIconChanged</a></b> ( const QIcon &amp; <i>icon</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetIconChanged-2">widgetIconChanged</a></b> ( int <i>index</i>, const QIcon &amp; )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetLabelChanged">widgetLabelChanged</a></b> ( const QString &amp; <i>label</i> )</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#widgetLabelChanged-2">widgetLabelChanged</a></b> ( int <i>index</i>, const QString &amp; )</td></tr>
</table>
<ul>
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#signals">QWidget</a></li>
<li><div bar="2" class="fn"></div>1 signal inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#signals">QObject</a></li>
</ul>
<hr />
<a name="reimplemented-protected-functions"></a>
<h2>Reimplemented Protected Functions</h2>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">virtual bool </td><td class="memItemRight" valign="bottom"><b><a href="qwwnavigationbar.html#eventFilter">eventFilter</a></b> ( QObject *, QEvent * )</td></tr>
</table>
<ul>
<li><div bar="2" class="fn"></div>37 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#protected-functions">QWidget</a></li>
<li><div bar="2" class="fn"></div>1 protected function inherited from <a href="http://qt.nokia.com/doc/4.7/qpaintdevice.html#protected-functions">QPaintDevice</a></li>
<li><div bar="2" class="fn"></div>7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
</ul>
<h3>Additional Inherited Members</h3>
<ul>
<li><div class="fn"></div>1 public type inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#public-variables">QObject</a></li>
<li><div class="fn"></div>4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#static-public-members">QWidget</a></li>
<li><div class="fn"></div>4 static public members inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#static-public-members">QObject</a></li>
<li><div class="fn"></div>37 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#protected-functions">QWidget</a></li>
<li><div class="fn"></div>1 protected function inherited from <a href="http://qt.nokia.com/doc/4.7/qpaintdevice.html#protected-functions">QPaintDevice</a></li>
<li><div class="fn"></div>7 protected functions inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-functions">QObject</a></li>
<li><div class="fn"></div>1 protected slot inherited from <a href="http://qt.nokia.com/doc/4.7/qwidget.html#protected-slots">QWidget</a></li>
<li><div class="fn"></div>1 protected type inherited from <a href="http://qt.nokia.com/doc/4.7/qpaintdevice.html#protected-variables">QPaintDevice</a></li>
<li><div class="fn"></div>2 protected variables inherited from <a href="http://qt.nokia.com/doc/4.7/qobject.html#protected-variables">QObject</a></li>
</ul>
<a name="details"></a>
<hr />
<h2>Detailed Description</h2>
<p>The QwwNavigationBar class provides a widget similar to MS Outlook navigation bar.</p>
<p align="center"><img src="images/qwwnavigationbar.png" alt="Navigation bar" /></p><a name="action-management"></a>
<h3>Action management</h3>
<p>Actions can be added to a navigation bar which causes buttons representing them to appear in the bottom of the widget.</p>
<hr />
<h2>Property Documentation</h2>
<h3 class="fn"><a name="currentIndex-prop"></a>currentIndex : int</h3>
<p>This property holds this property holds the index position of the current bar.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><b>currentIndex</b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b>setCurrentIndex</b> ( int <i>index</i> )</td></tr>
</table>
<h3 class="fn"><a name="topWidgetVisible-prop"></a>topWidgetVisible : bool</h3>
<p>This property holds this property holds whether the top widget is visible.</p>
<p>If this property is true then a widget containing the current group is shown at the top of the widget. This property is true by default.</p>
<p><b>Access functions:</b></p>
<table class="alignedsummary" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><b>topWidgetIsVisible</b> () const</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><b>setTopWidgetVisible</b> ( bool <i>v</i> )</td></tr>
</table>
<hr />
<h2>Member Function Documentation</h2>
<h3 class="fn"><a name="QwwNavigationBar"></a>QwwNavigationBar::QwwNavigationBar ( <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>parent</i> = 0 )</h3>
<p>Constructs a navigation bar widget with a given <i>parent</i></p>
<h3 class="fn"><a name="addWidget"></a>void QwwNavigationBar::addWidget ( <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>child</i>, const <a href="http://qt.nokia.com/doc/4.7/qicon.html">QIcon</a> &amp; <i>icon</i>, const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; <i>label</i> = QString::null )</h3>
<p>Adds <i>child</i> with <i>icon</i> and <i>label</i> to the navigation bar at the last position.</p>
<h3 class="fn"><a name="addWidget-2"></a>void QwwNavigationBar::addWidget ( <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>child</i>, const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; <i>label</i> = QString::null )</h3>
<p>This is an overloaded function.</p>
<h3 class="fn"><a name="button"></a>const <a href="http://qt.nokia.com/doc/4.7/qpushbutton.html">QPushButton</a> * QwwNavigationBar::button ( int <i>index</i> ) const</h3>
<p>Returns pointer to a button associated with a child under <i>index</i></p>
<h3 class="fn"><a name="currentIndexChanged"></a>void QwwNavigationBar::currentIndexChanged ( int <i>index</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted whenever the current index of the widget changes to <i>index</i></p>
<h3 class="fn"><a name="eventFilter"></a>bool QwwNavigationBar::eventFilter ( <a href="http://qt.nokia.com/doc/4.7/qobject.html">QObject</a> *, <a href="http://qt.nokia.com/doc/4.7/qevent.html">QEvent</a> * )&nbsp;&nbsp;<tt> [virtual protected]</tt></h3>
<h3 class="fn"><a name="indexOf"></a>int QwwNavigationBar::indexOf ( <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>widget</i> ) const</h3>
<p>Returns an index of <i>widget</i> in the navigation bar</p>
<h3 class="fn"><a name="insertWidget"></a>void QwwNavigationBar::insertWidget ( int <i>index</i>, <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>child</i>, const <a href="http://qt.nokia.com/doc/4.7/qicon.html">QIcon</a> &amp; <i>icon</i>, const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; <i>label</i> = QString::null )</h3>
<p>Inserts widget specified by <i>child</i> with <i>icon</i> and <i>label</i> to the navigation bar under position <i>index</i></p>
<h3 class="fn"><a name="insertWidget-2"></a>void QwwNavigationBar::insertWidget ( int <i>index</i>, <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>child</i>, const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; <i>label</i> = QString::null )</h3>
<p>This is an overloaded function.</p>
<h3 class="fn"><a name="removeWidget"></a>void QwwNavigationBar::removeWidget ( int <i>index</i> )</h3>
<p>Removes widget specified by <i>index</i> from the navigation bar</p>
<h3 class="fn"><a name="setCurrentWidget"></a>void QwwNavigationBar::setCurrentWidget ( <a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * <i>widget</i> )</h3>
<p>Sets <i>widget</i> as the currently visible widget.</p>
<h3 class="fn"><a name="setWidgetIcon"></a>void QwwNavigationBar::setWidgetIcon ( int <i>index</i>, const <a href="http://qt.nokia.com/doc/4.7/qicon.html">QIcon</a> &amp; <i>icon</i> )</h3>
<p>Associates <i>icon</i> with a widget under <i>index</i></p>
<p>See also <a href="qwwnavigationbar.html#widgetIcon">widgetIcon</a>().</p>
<h3 class="fn"><a name="setWidgetLabel"></a>void QwwNavigationBar::setWidgetLabel ( int <i>index</i>, const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; <i>label</i> )</h3>
<p>Sets <i>label</i> as the title for the widget under <i>index</i></p>
<p>See also <a href="qwwnavigationbar.html#widgetLabel">widgetLabel</a>().</p>
<h3 class="fn"><a name="topWidgetVisibleChanged"></a>void QwwNavigationBar::topWidgetVisibleChanged ( bool <i>vis</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted whenever visibility of the top widget changes to <i>vis</i></p>
<h3 class="fn"><a name="widget"></a><a href="http://qt.nokia.com/doc/4.7/qwidget.html">QWidget</a> * QwwNavigationBar::widget ( int <i>index</i> ) const</h3>
<p>Returns a pointer to the widget at position <i>index</i></p>
<h3 class="fn"><a name="widgetCount"></a>int QwwNavigationBar::widgetCount () const</h3>
<p>Returns the number of widgets in the navigation bar.</p>
<h3 class="fn"><a name="widgetIcon"></a><a href="http://qt.nokia.com/doc/4.7/qicon.html">QIcon</a> QwwNavigationBar::widgetIcon ( int <i>index</i> ) const</h3>
<p>Returns icon of the widget under <i>index</i></p>
<p>See also <a href="qwwnavigationbar.html#setWidgetIcon">setWidgetIcon</a>().</p>
<h3 class="fn"><a name="widgetIconChanged"></a>void QwwNavigationBar::widgetIconChanged ( const <a href="http://qt.nokia.com/doc/4.7/qicon.html">QIcon</a> &amp; <i>icon</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted when the icon of the current widget changes to <i>icon</i>.</p>
<h3 class="fn"><a name="widgetIconChanged-2"></a>void QwwNavigationBar::widgetIconChanged ( int <i>index</i>, const <a href="http://qt.nokia.com/doc/4.7/qicon.html">QIcon</a> &amp; )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<h3 class="fn"><a name="widgetLabel"></a><a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> QwwNavigationBar::widgetLabel ( int <i>index</i> ) const</h3>
<p>Returns label of the widget under <i>index</i></p>
<p>See also <a href="qwwnavigationbar.html#setWidgetLabel">setWidgetLabel</a>().</p>
<h3 class="fn"><a name="widgetLabelChanged"></a>void QwwNavigationBar::widgetLabelChanged ( const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; <i>label</i> )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p>This signal is emitted when the label of the current widget changes to <i>label</i>.</p>
<h3 class="fn"><a name="widgetLabelChanged-2"></a>void QwwNavigationBar::widgetLabelChanged ( int <i>index</i>, const <a href="http://qt.nokia.com/doc/4.7/qstring.html">QString</a> &amp; )&nbsp;&nbsp;<tt> [signal]</tt></h3>
<p /><address><hr /><div align="center">
<table width="100%" cellspacing="0" border="0"><tr class="address">
<td width="30%" align="left">Copyright &copy; 2007-2010 Witold Wysota 
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
<td width="30%" align="right"><div align="right">wwWidgets 1.0.0</div></td>
</tr></table></div></address></body>
</html>
